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Abstract 



Game Master Radio (GMR) sets out to provide a playlist of music that the user (a 
tabletop Game master) can use to change the mood (Suspense, Battle, Travelling, 
etc.) to suit what is happening in her game. 

This is to allow a Dungeons & Dragons (D&D) game to benefit from the same 
story-following music that films & computer games have. 

The web service allows for fine-grained selection of the mood of the music, and 
allows for end-user tagging of the music to benefit from the collective intelligence 
of the users. 

The end result is a web 2.0 service that can benefit any table-top game, re- 
gardless of the theme. During the development, I researched Web 2.0 practices 
and methods and my findings are included in this report. 
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Tristram Oaten grew up in rural Cornwall, UK. He graduated from the University 
in Plymouth in 2008, then studied MSc Software Engineering at Southampton, 
where he graduated in 2009. He currently works as a Systems Administrator at 
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1 Acknowledgments 



1.1 GMR Project Team 

GMR could not have been created without the support of my colleague, Karl 
Williams. I was able to design the back-end of the software and compose most 
of the music for the site, my web design skills benefited from his support. Karl's 
experience of web design allowed us to build not only a solid service, but an 
attractive web site that is enjoyed by our users. In Django's Model/ View/Template 
framework, Karl wrote the majority of the templates. The blog engine was written 
by Nick Bartley, a good friend of mine and a brilliant engineer. 

1.2 Open Source Community 

The quality of the final service is so good, thanks to the following software giants 
on whose shoulders I am standing: 

1.2.1 Python / Django 

The project could never have been completed, or incorporated so many features 
in the time frame allocated without the combination of the Python programming 
language and the web framework Django. Python's concise syntax coupled with 
Django's high-level Model/ View/Controller framework have allowed me to rapidly 
develop the core services while Karl has been able to assist by creating independent 
HTML templates. 

1.2.2 Trac Project Management 

This is an extract from the Trac project sitefl], 

"Trac is an enhanced wiki and issue tracking system for software development 
projects. It uses a minimalistic approach to web-based software project manage- 
ment. Our mission is to help developers write great software while staying out of 
the way. Trac should impose as little as possible on a team's established develop- 
ment process and policies. " 

I used Trac in the first half of the project to organise tickets, bugs and the roadmap. 
In the second half of the project, I moved from Trac to GitHub[2], a much newer 
and (co-incidentally) Web 2.0 - oriented management solution. 

1.2.3 Git / Github.com 

Git is a great versioning system. It has a fantastic interface that brings Git's easy 
forking and merging to the fore. 
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2 Introduction 



The idea for Game Master Radio was given to me by my wonderful fiancee when 
she answered my rhetorical question "How can I link my love of programming, 
music and Dungeons & Dragons (D&D) 1 ". She promptly suggested, "What about 
a D&D-themed radio?" . 

What a great idea! Gamemaster-selectable background music could really en- 
hance the game experience of the players round the table. 

After much trawling of the Internet, I found many playlist-based Internet radio 
stations using technologies such as Sshoutcast to provide the user with a playlist 
of rock, pop and many other genres which, seemingly, just selected titles based 
on what the owner of the site liked listening to whilst playing various computer 
games. While Led Zeppelin might be stereotypical D&D fare, I felt that any music 
with lyrics is just too distracting given the essentially vocal nature of any game 
involving a group of players and would not add to the ambiance of the game. 

What I imagined at the time was a music service that could match the mood 
(Combat, Suspense, etc.) of what was happening in the game. 

2.1 Web 2.0 Brief 

Web 2.0 is a difficult topic for many; to some it is just a buzzword with very 
poorly defined meaning. Tim O'Reilly was the first to try and quantify what a 
successful web 2.0 company (and therefore service) is. In his paper, What is Web 
2.0: Design Patterns and Business Models for the Next Generation of Software[3] 
O'Reilly states that the key disciplines are: 

1. Control over unique, hard-to-recreate data sources that get richer as more 
people use them, 

2. Trusting users as co-developers, 

3. Harnessing collective intelligence, 

4. Leveraging the long tail through customer self-service, 

5. Software above the level of a single device, 

6. Lightweight user interfaces, development models, AND business models. 
1 A tabletop role playing game played with polyhedral die & thick rulebooks. 
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2.2 Terminology 

I use the acronym O/S for "Operating System" and OS for "Open Source", I also 
abbreviate Object Oriented to 00. 

Often I use code to mean source code. Many of my sentences would be quite a 
mouthful if I used source code more than a few times in them. Occasionally I use 
the expression to hack or hacking. The common misconception is that hacking is 
breaking into computer systems. It is not, that is cracking. "Hackers build things, 
crackers break them" [4] 

2.2.1 Dungeons & Dragons 

Wikipedia has this to say about Dungeons & Dragons: Dungeons & Dragons is a 
structured yet open-ended role-playing game. It is normally played indoors with the 
participants seated around a table-top. Typically, each player controls only a single 
character, which represents an individual in a fictional setting. As a group, these 
player characters (PCs) are often described as a "party" of adventurers [...] During 
the course of play, each player directs the actions of his or her character and its 
interactions with the other characters in the game. [...]A Dungeon Master serves as 
the game's referee and storyteller, while also maintaining the setting in which the 
adventures occur[...]A game often continues over a series of meetings to complete 
a single adventure, and longer into a series of related gaming adventures, known 
as a "campaign" . 2 

Dungeons & Dragons is a game that takes place in the minds of the players. 
There are miniature figurines that you can physically move around a map, but 
this is more an aid to memory. 

2.3 GMR Brief 

"A Game Master (often abbreviated as GM) is a player in a multiplayer game who 
acts as organizer, arbitrator, and officiant in rules situations. " -Wikipedia, June 
2009. 

I set out to provide a playlist of music that the user (A tabletop Game master 3 ) 
can use to change the mood (Suspense, battle, travelling, etc.) to suit what is 
happening in her game. 

2 http: / / en.wikipedia.org/ wiki /Dungeons _& -Dragons. 
3 http:/ / cn.wikipedia.org/ wiki / Game .Master. 
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3 Language Review and Research 



3.1 Language Review 

3.1.1 C# on ASP.NET 

An inappropriate choice 

ASP.NET is a very popular web framework, and indeed the number one skill that 
the job market is searching for at the moment. However, it is not necessarily 
the most appropriate application to use. C# is closed-source and limited to the 
windows platform and therefore the x86 architecture under it. ASP.NET uses 
Microsoft's Visual Studio IDE which is held in very high esteem by the industry 
as one of the best IDEs available. C#'s syntax is very similar to Java's syntax. If 
Microsoft set out to clone Java, they have certainly done a good job, the barrier to 
entry for Java programmers is very low because of the transferable skills. However 
in the context of this project, it is not the best option. 

3.1.2 Ruby on Rails (RoR) 

Sub optimal 

Ruby is a dynamic, interpreted language much like Python. Indeed, the syntax is 
so similar it leads me to wonder why this Python clone was created. Instead of 
dividing the community, why was the effort not put towards making Python better? 
However, we have a lot to thank Ruby on Rails for. RoR was among the first 
MVC 4 script-based web frameworks which (compared with traditional methods) 
allows for incredibly fast development. The publicity that was generated by this 
(previously) little-known language was groundbreaking, and set the standard for 
many web frameworks afterwards. 

3.1.3 Groovy on Grails 

Close but not quite 

Groovy is a dynamic scripting language for the Java Virtual Machine, Grails is 
a web framework built around this. In many respects it is like RoR and Django, 
though it shares more with RoR, especially the scaffolding, that Django lacks. 
Grails has a pretty hefty footprint of at least 60MB of RAMAlthough the language 
is dynamic, the scripts still need to be compiled to Java bytecode, slowing down 
development. The biggest factor which militates against Grails is that the web 
server used in production, Tomcat, is unusual to host on. As such, it is quite 
expensive to use as a virtual host when compared with Apache that Django and 
Rails can be hosted on. 

4 Model View Controller. 
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3.1.4 Python / Django 



The logical option 

Django is of one of the most popular web frameworks based on Python. Django 
uses the similar MVC paradigm that Rails & Grails uses, but lacks a scaffolding to 
produce auto-generated views for testing the model. Django, however, makes up 
for this by having an exemplary administrator interface into these models. I have 
chosen Django because of my experience with Python and Django's rich feature-set 
for rapid application development. 

3.2 Project Management 

3.2.1 Trac / Subversion 

Subversion is a mature, well-established version control system that I have used 
extensively in the past, with much success. Trac is a highly-efficient Python- 
powered wiki and issue tracking system. By default it links to Subversion and can 
keep track of changes in a well-presented web user interface. 

Trac & Subversion are a popular combination for open source projects, as an 
alternative to Sourceforge or Google Code. I also used it for my undergraduate 
dissertation, PIMMS[5]. 

3.2.2 Git 

Git is an evolution of classic, older versioning systems. Its biggest change is that 
each developer's local working directory is a copy of the whole repository, with all 
the revisions available locally. Git focuses on fast and easy forking and merging 
of repositories, something that is far more time-consuming to do in a traditional 
version control system. 

3.3 Existing Solution Research 

As with any project, it is necessary to take a look at the competition (if there is 
any) and at what is available from those other companies that may be producing 
something similar. 

I have opted to work on this project as my investigations have revealed that 
no other web services in the area of gaming ambiance have software which offers 
the facilities available with this application. 

This site is indicative of the limited-scope of the web services that I have come 
across as part my research. Typically, the music was just pulled from the charts or 
other popular music. There was no overall theme, and the music is, in my opinion, 
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too distracting for serious use in a game, the gamers would either have to sit in 
silence, or turn down the music to the point of not being able to discern the lyrics. 

3.3.1 obsidianportal.com 

This was the only site which came anywhere near offering the facilities presented 
by GMR. Although not a radio station, Obsidian Portal has a large toolkit for 
the Game Master and includes Game wikis, NPC 5 tracking and game logs. It is a 
very well put together website with many of the same ideas as GMR. While I was 
developing GMR, I emailed the creator of Obsidian Portal, a helpful guy called 
Micah, in the hope of getting some advice. What I didn't expect was that he 
would give me such great advice! 

"Most of the audience is a mature group (20+) with disposable income, not 
penniless teens. It's not a huge leap to assume they will spend some $ on a good 
web app." This was encouraging, it seemed the market was suitable for this type 
of application. 

"Don't depend on ads. Period. Ad revenue sucks and keeps getting worse. 
Make people pay you for your software. If you don't think people will be willing 
to pay, then either don't write it or don't expect to make any money. " This was 
not as encouraging. However, it was very valuable, as it put the idea of ads out of 
my head and forced me to focus on where the direct revenue would come from - 
our users. 

5 Non-Player Characters, the goblins, elves and other mythical creatures. 
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4 Aims and Objectives 



4.1 Definition of Problem 

A game of Dungeons & Dragons (Or any other similar tabletop role-playing game) 
is often played with some background music, something quiet that does not de- 
tract from the game. However, this music can only be chosen to have very slight 
correlation to the story - and certainly not the ups and downs of the action as 
the game progresses. Contrast this with a video game, or a film. In both, the 
musical score is chosen to tie in very closely with what is happening on-screen. 
This enhances the experience greatly. I feel that tabletop role-playing games are 
so similar to films and video games that tell a story, that there must be a way to 
get a more tailored musical accompaniment. 

4.2 Aims 

My aims were twofold: 

1. Make available a playlist of music that would allow the user (the Dungeon 
Master or Game Master) to instantly change the mood (Suspense, battle, 
travelling, etc.) to suit what is happening in the game. 

2. Use Web 2.0 practices insofar as I understood them at the time, in order to 
gain a clearer understanding of them. 

4.3 Objectives 

4.3.1 Implementation 

With GMR, I aim to have a live web site where users could access the site features 
from anywhere that has broadband and a browser that supports Flash. The site 
should be able to serve hundreds, if not thousands of concurrent users. 

4.3.2 Evaluate Solution 

I shall evaluate the final product by focusing on the final period of testing, which 
will be the Public Beta phase. In this final period, very few additions to the 
systems can be incorporated, only bug fixes and clarity-enhancing patches. I will 
be responding to users feedback mainly in this time, reactive maintenance. 
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4.3.3 Software desiderata using MoSCoW Prioritisation 

Must-have 

1. A mechanism to play music 

2. A mechanism to select the mood of the music 
Should-have 

1. A fine-grained genre-selection mechanism 

2. User-classified metadata 
Could-have 

1. A comprehensive search 

2. Premium subscriber-only features. 
Won't have 

1. Commercial radio with lyrics 

2. User/client platform dependencies 

4.4 Method of Approach 

Designing the database gave me a solid starting point to start work on the code, 
after implimenting a very simple genre-selection list, I then turned my attention 
to musicplayer. 

After reading up on the XSPF playlist format, I wrote a simple playlist with 
one hard-coded mp3 to stream. This worked as expected, so I linked it to my genre- 
selection list. Oncew the simple genre selection worked, I re- wrote the model with 
the fine-grained genre selection and repeated the process. 

To ensure that no hidden bugs remained, I performed both bottom up and 
overall testing on the system, after it appeared to be working. 
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5 Design 



5.1 Initial Design of Prototype 

My biggest initial problem is that I have no experience with Adobe's ubiqui- 
tous Flash. Flash is essential for the user to hear my music. I had no intention 
of learning Actionscript, the technology behind Flash, as it is is not Free Soft- 
ware. However, I discovered an open source pre-compiled Flash mp3 player called 
Musicplayer[6] . Musicplayer is just what I was looking for: simple enough to be 
configured by one XML file, but flexible enough to integrate into GMR. 
Musicplayer has been doing things correctly, the playlist format is based on the 
open standard XSPF[7] which has a clear syntax: 



<?xml version=" 1 . 0 " encoding = " UTF -8 " ? > 
<playlist version="l" xmlns = " http : // xspf . org/ns /0/ " > 
<trackList> 
<track> 

< ! -- mp3 location --> 

<location>http: // example . com/so ng_l .mp3</location> 

< ! -- artist or band name --> 
<creator >Led Zeppelin</ creator > 

< ! -- album title --> 
<album>Houses of the Holy</album> 

< ! -- name of the song --> 
<title>No Quarter</title> 

< ! -- album art --> 
<image>http: //images . example . com/ art . jpg</image> 

< ! -- URI of the original web page --> 
<info>http: // example . com</info> 
</track> 
</ trackList > 
</playlist > 

I saw that it was going to be straightforward to pull my data from the eventual 
database and plug it into the playlist file. 
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5.1.1 Django Models 



Django has a splendid ORM 6 that allowed me to quickly develop GMR without 
writing a single line of SQL (At my previous University, I wrote my own ORM for 
my dissertation, Django saved me this job). 

With Django, it is possible to write a model like this: 

class Feedback (models . Model ) : 

subject = models . CharField (max_length=20) 
description = models . TextField () 



Using this simple class, Django builds a Feedback table with the appropriate 
fields, and automatically adds a primary key ID which is an auto-incrementing 
integer field - something that a database designer would often do as standard. 

With the model set up, it is a simple matter to use the database in the object- 
oriented controllers file: 



fl = Feedback ( sub j ect =' Des ign ' , des cript ion= ' Love the 

site ' ) 
f 1 . save () 



The initial model (as of private Beta) is as follows: 



1 
2 
3 
4 
5 
6 
7 
8 
9 

10 
11 
12 
13 
14 
15 
1G 



from django. db import models 

class Genre (models . Model ) : 

genre = models . CharField (max_length=200) 

def __unicode__ ( self ) : 
return self . genre 

class Track (models . Model ) : 

name = models . CharField (max_length=200) 
url = models . CharField (max_length=200) 
art = models . CharField (max_length=200) 
genre = models . ForeignKey ( Genre ) 

def __unicode__ ( self ) : 
return self .name 



6 Object-Relational Mapping, a database wrapper that allows interaction through high-level 
objects. 
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5.2 Prototyping 



Another benefit of the rapid application development that Django provides is that 
there was no need to use a separate tool for prototyping. 

After creating an initial web app based on the above models, I decided to push 
ahead with the "fine-grained" genre selection aim, this prompted the redesign. 

6 Redesign 

After the limitations that pigeon-holing tracks into genres like "combat" or "sus- 
pense" became apparent, I needed a different categorisation system. Taking a 
hint from UNIX file permissions, I thought of the idea of that each category can 
be given group of digits that indicate how strong the track is weighted in each 
category. After some brainstorming with my colleague Karl, we came up with the 
four categories: 

1. Speed 

2. Combat 

3. Suspense 

4. Positivity (The higher the number, the more "pleasant", or "uplifting" the 
sound of the music) 

Each one can be given a value of 0 - 9, so that a fast, discordant track might be 
classified as 8-7-8-2 (Fast, lots of combat & suspense, whereas a slower, cheerful 
song would be categorized as 3-2-1-8. 

6.1 Open Source 

My collaborator, Karl, & I started the project with a closed-source mentality. Our 
premise was that if we intend to eventually make a profit out of GMR, we should 
keep our source closed. 

As keen open-source advocates, we felt bad about this, but the vague notion that 
closed source software is safer to market kept us with closed-source. 

Github forced our hand, however. Github provides unlimited free accounts - 
provided that the source is open. Github.com charge $12 per month for a package 
that will let more than one collaborator work on a single project. However, as the 
project had no source of funding, we could not afford the expense. We were unsure 
if open source was the way to go, so we sat down and made a Pros vs Cons table. 
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Pros 


Cons 


Free development 

Self publicity 

The Right Thing™ 

Author's credit (if forked) 

Free GIT hosting 


Loss of source control 
Facilitates competition 



Pros & Cons of Open Sourcing GMR 



These are by no means the only criteria, but they were the ones that mattered to 
us at the time. We then went on to look at the 4 possible outcomes: 





Open Source 


Closed Source 


Project 
Success 


Win. The service attracts a lot of users, 
and the popularity helps development 
as anyone can contribute. 


Win. The service attracts a 
lot of users 


Project 
Failure 


Perhaps some competition came along 
and used our framework with a larger 
music library. We've been beaten, but 
the competition uses our software, is 
this a total loss? 


The project has failed, and 
we have nothing to show for 
it. No one can pick up the 
baton, because the software 
is closed. 



Open Source Vs Closed 
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This analysis clearly showed that the selling point of the service isn't its soft- 
ware, it is the music library. It's a radio service, music is paramount. 
We decided to open-source gamemasterradio. The software is freely avalable for 
anyone to view and modify at http://github.com/oatman/gmr 

6.2 Github 

Github provides an excellent interface into the Git version control system. It's 
feature-set is superficially similar to Trac, in that it provides a file browser, wiki & 
a bug-tracking system. However, it uses a very modern approach to the interface. 
A great deal of AJAX 7 makes the interface very pleasant to use. The use of key- 
board shortcuts throughout is a real productivity booster. When navigating the 
"issues" section, for example, they have the same shortcuts that gmail and many 
other applications employ: 



Shortcut 


Action 


J 


Move cursor down 


K 


Move cursor up 


X 


Select current 


G-I 


Go to Inbox 



6.3 Github and Scrum 

I used the issues section of Github as the Scrum backlog, a 'holding-pen' of features 
yet to be developed, but ones we didn't want to forget about. The features were 
written as user stories. User stories are a great way of bringing the user onboard in 
a very agile way. User stories require all features to be written as short sentences, 
written by the user and from their point of view. 



7 Asynchronous Javascript & XML. 
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An example of a user story would be, 
As a dungeon master, I should be able to change the genre of the radio in order to 
set the mood the the game. 

The benefit of this story is obvious to the user, and because they can understand 
it (it is written in layman's language) they can prioritise it. 

The rules we formalised for our user stories are as follows (added to, and modified 
from User Stories Applied): 

1. Title: The user story (A user can send messages to other users) 

2. Body: Acceptance tests & other info (keep it brief) 

3. Label: The estimated size of the story (in T-shirt sizes) 

A good user story: 

• Is written from the point of view of a user 

— Good: "All errors are presented to the user & logged in a consistent 
manner" 

— Bad: "All error handling and logging is done through a set of common 
classes" 

• Is written as if the user is female: 

— Good: "A student can add her comment to a track" 

— Bad: "A Student can add their comment to a track" 

(This is due to the ambiguity of the English language, "their" can be 
viewed as plural. It makes no difference which gender is used, but we 
have to select one. Our convention will be female.) 

• Is estimated in T-shirt sizes: 

— XS (a few hours) 

— S (about a day) 

— M (a few days) 

— L (about a week) 

— Epic (More than a week, split it down) 
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6.4 Scrumy 



Scrumy.com is a web service created to solve a very specific problem. In scrum, 
a critical organisational tool is regular code review meetings to talk about where 
each developer is and what they will be working on. This is facilitated by a task 
board. This is a grid looking something like this: 



Stories 


To Do 


In Progress 


Verify 


Done 


A user can tune in to the 
genre she wants 


Web UI 




DB Backend 





A Scrum task board. 



Each story can have one or more tasks. These tasks (such as Web UI ) are 
moved across the board as the programmer is developing the task. This is a great 
organisational tool that encourages watercooler-esque discussion. 
However, in a distributed team, this crucial tool is impossible to use. Scrumy.com 
solves this with an excellent web-based replacement. 

6.5 Entity-Relationship Diagram 



-n-ack 

- name : char 

- artist : char 

- url : char 

- art : char 

- gSpeed : int 

- gCombat : int 

- gSuspense : int 

- gPositive : int 

+ getGenreO : string 
+ ensurePositive(val : int) : int 
+ getDeviationQ : string 

This ERD represents the final database model. 



Feedback 

- user : User 

- url : short 

- subject : string 

- description : string 
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6.6 Construction of Product 

From the ERD in the previous section, the Django model was created. 



class Track (models . Model ) : 

name = models . CharField (max_length=200) 
artist = models . CharField (max_length=200) 
url = models . CharField (max_length=200) 
art = models . CharField (max_length=200) 
gSpeed = models . IntegerField () 
gCombat = models . IntegerField () 
gSuspense = models . IntegerField () 
gPositive = models . IntegerField () 



def ensurePo s it i ve ( self , val ) : 
if val < 0: 

return val * -1 
else : 

return val 

def getDeviation(self , Speed , Combat , Suspense , Positive 
) : 

deviationSpeed = int(Speed) - self . gSpeed 
deviationCombat = int (Combat) - self . gCombat 
deviationSuspense = int ( Suspense ) - self. 
gSuspense 

deviat ionPos it ive = int ( Pos it ive ) - self. 
gPositive 

deviation = self . ensurePo s it ive ( devi at ionSpeed ) 
+ 

self . ensurePositive (deviationCombat) + 
self . ensurePositive (deviationSuspense) + 
self . ensurePositive (deviationPositive) 
return deviation 

class Feedback (models . Model ) : 

user = models . ForeignKey (User ) 
url = models . CharField (max_length=100) 
subject = models . CharField (max_length=20) 
description = models . TextField () 
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6.6.1 Model Explanation 

• getDeviation is used when the user selects the genre of music that she wants 
(for example, 1-2-3-4) and a for loop is called comparing each track object 
to the search string, returning a deviation value of how much the track is 
different from what the user wants. These are then arranged in order of 
similarity and passed to the playlist view which creates an XML playlist 
ready for musicplayer to play them. 

• ensurePositive is a very simple method that simply converts all negative 
integers to be positive. This makes the deviation calculation simpler and 
easier to read. 

6.7 Music Production 

Although a little outside the scope of this, a Software Engineering dissertation, 
the following are some of the technologies I used in the production of the music. 
GMR is, after all, a radio service! 

My principal input is an evolution MK-149 4-octave MIDI slave keyboard. 
MIDI is the primary protocol used to play-in and store my compositions. It has 
a very simple pitch/velocity/duration notation and has been the standard for 27 
years. 

When I am not satisfied with just digital music, I use either my electro/ acoustic 
guitar or my Les Paul electric guitar to play in some licks. 
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7 Testing 



7.1 Development Setup 

After shopping around, I found a fantastic hosting company called webf action [8], 
who for a few dollars a month offer a very generous Django hosting package. They 
also support seamless upgrading to a virtual server. This will be important if 
and when GMR becomes popular and we have to upgrade our service. With this 
service I set up the following: 



Subdomain 


Function 


dev.gamemasterradio.com 
radio . gamemast err adio . com 
svn.gamemasterradio.com 
trac.gamemasterradio.com 


Django development instance 
Django live instance 
Subversion version control 
Track project management 



Domain configuration. 



7.2 User Feedback 

We received lots of great feedback from our closed-beta testers, they fell approxi- 
mately into three categories. 

7.2.1 Positive 

xtina: "I like the voting system. I think even though I am not a gamer it will be 
better by the time [it launches]. It has great potential and design." 

7.2.2 Suggestion 

BaTh: "It would be nice if you could alter the mood in real time rather than 
having to begin a new radio session." 

7.2.3 Co-developer 

lewis: 'When you submit the ajax query, get the response to include the new 
figures array and then javascript that mother in there. If javascript remote calls 
fails, then just do a javascript refresh for graceful degrading." 

This is the feedback that embodies Web 2.0 thinking. By treating our users as 
our most important asset, they have responded by becoming just that. 
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8 Review 



8.1 Critical appraisal 

I believe the software portion of the project was a great success, the framework 
we have created is robust, fast and I am sure will be a popular application. It 
was difficult to draw many meaningful conclusions from the Web 2.0 aspect due 
to the small number of users that have signed up so far, but I have documented 
my results in the following section. 

8.1.1 Improvements 

There remain a few bugs that I had not had time to fix, in the coming months I 
hope to fix them to bring GMR up to production-level quality. 

1. Users can tweak the track attributes (Speed, suspense, etc.) unlimitedly 
at the moment. This leaves the system open to abuse by a malicious user 
setting all the tracks to 0 0 0 0, or otherwise polluting the metadata. The 
solution to this is to limit each user to one change per track per day. 

2. At the moment there is no description of the track on the info page. This 
would be nice to have. 

3. As per the project's Private-Beta status, it is not possible for a user to self- 
register. In future releases, this functionality will be added. 

9 Discussion 

9.1 Reflection on outcome 

My aims were to: 

1. Make available a playlist of music that would allow the user (the Dungeon 
Master or Game Master) to instantly change the mood (Suspense, battle, 
traveling, etc.) to suit what is happening in the game. 

2. Use Web 2.0 practices insofar as I understood them at the time, in order to 
gain a clearer understanding of them. 
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9.2 Conclusions 



Django is an amazing framework for building web applications and services, and 
is a natural match for Agile development and Scrum. 

Prior to this project, I had not used an Agile methodology like Scrum. What 
an eye-opener Scrum was! It will certainly be effective in pushing the development 
forward while being responsive to change. 

Working with my frontend colleague, Karl, proved to be an excellent collabo- 
ration. Single-hand projects are very taxing unless you are unemployed or have 
infinite energy to learn all the disciplines that are required in the project. 

9.3 Recommendations 

Agile and Web 2.0 are a great combination. Agile methods allow for the "Lightweight 
[...] development models, AND business models." that O'Reilly identifies. 

My advice to any small team attempting this scale of project is to use an 
Agile process like Scrum. The freedom it gives the developer from heavyweight, 
formalized methods is amazing, not to mention the splendid results and accurate 
estimation. 
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Appendix 



A Screenshots 



|T Add entry | Django si... 

4> -> O H & http://localhost:8000/admin/blog/entry/add/ 



Django administration 



Home Blog ■ Entries i Add entry 

Add entry 

Title: fl 



Draft » Author: 



Body html: 




Date 

published: 



Tags: 
Slug: 



Date: Today Q 

Time: ] Now Q 



Save and add another Save and continue editing 



Adding a blog entry using the Django admin system. 



W Q Add entry | Django si... 
<- C H # http:'/localho5t:8000/admin/blog/entry/add/ 



Django administration 



Home i Blog ■ Entries > Add entry 



Add entry 

Title: 

Body html: 



Welcome To GMR! 



Status: 



Published ▼ Author: 



Tristram Oaten 



Hi all. 

Welcome to the site, we've worked hard on it and we hope you like it! 

Play around and let us know what you think 

-Tris 



Date 

published: 


Date: 2009-09-23 Today g 
Time: 19:50:12 Now Q 






Tags: 


welcome, blog, intro 






Slug: 


welcome-gmr 

Automatically built from the title. 










Save and add another 


Save and continue editing ^ 



The populated blog entry fields. 
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Django administration 



Home Blog • Entries 



© The entry "Welcome To GMR!" was added successfully. 

Select entry to change 





Title Date published * 


Status 


Author 


Welcome To GMR! Sept 23. 2009. 7:50 p.m. 


Published 


Tristram Oaten 



The new blog entry in the list. 



By Date published 

Any date 

Today 
Past 7 days 
This month 
This year 

By status 

AM 

Draft 
Published 

By author 

| All 

Tristram Oaten 



JT Welcome To GMR! | Bl... ^^^^^m^^^^^^^^^f^^ 

* -> I CI <l 1 1 A http://localhost:8000/blog/2009/sep/23/welcome-gmr/ 



► LV A- 



Game Master Radio 

1 * ' Music for your worlds 




Logged in as oatman. ( logout ) 



Home Blog Radio 



Welcome To GMR! 



2009-09-23 19:50:12 

Hi all. Welcome to the site, we've worked hard on it and 
we hope you like it! Play around and let us know what 
you think -Tris 
tags: blog , intro , welcome . 



back to blog 



All content © GMR 2009 unless specifically stated. 



The blog entry as it appears on the public blog. 
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<■ C H *C? http://localhost:8000/admin/radio/track/add/ 








Django administration 


Welcome, oatman. Change password / Log out 




Home > Radio > Tracks > Add track 




Add track 








Name: 








Artist: 








url: 








Art: 








G Speed: 








GCombat: 








G Suspense: 










G Positive: 












Save and add another Save and continue editing T 


: 



Adding a track using the Django admin system. 





4- C # http://localhost:8000/admin/ 


^^^^^^^^^^^^^^^ ► f" 


Django administration 


Welcome, oatman. Change password / Log out 



Site administration 





Groups 


♦Add 


.♦Change 


Users 


♦ Add 


.•Change 


Blog 


Entries 


♦ Add 


..•Change 


Radio 


Feedbacks 


♦ Add 


. • Change 


Tracks 


#Add 


. t Change 




Sites 


Sites 


♦ Add 


..•Change 








Tagging 


Tagged items 


♦ Add 


.•Change 


Tags 


♦Add 


.♦Change 



Recent Actions 



An overview of the Django admin system. 
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<■ C H ft http://localhost:8000/accounts/login/?next=/ 



Game Master Radio 

1 * Music for your worlds 




login 



Home Blog Radio 



Please log in 



Username 
Password 

login 



All content © GMR 2009 unless specifically stated. 



The login prompt. 



Game Master Radio 

«- C fi it 



'/localhost:8000/ 



V£ Game Master Radio 

' Music for your worlds 




Genre Selection 



Slow 
Peace 
Relaxed 
Negative 
Listen... 



□ 
□ 
□ 
□ 



Fast 
Combat 
Suspense 
Positive 



Logged in as oatman. ( logout ) 



All content © GMR 2009 unless specifically stated. 



The mood selection form. 
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Jj: Game Master Radio 
«- C fi it localhost 



► Q~ A- 



J,^ Game Master Radio 

' ' Music for your worlds 



Feedback 

We think that GMR rocks (and 
we're super-modest too). 
Agree? Disagree? Let us know 
why. 

Subject: 



Your comments: 



Fast 
Combat 
Suspense 
Positive 



Send 



Logged in as oatman. ( logout ! 



All content © GMR 2009 unless specifically stated. 



The A J AX feedback form. 



Game Master Radio 

Music for your worlds 




GMR Music Player 



Logged in as oatman. ( logout ) 



Home Blog Radio 



You are listening to 4-4-4-4 radio. 





1. INHTII 


2. MINIMAL PIANO 




■ . I R: m V E I ij N E 




11. AMBIENT 




S. COUNTRY DANCE 




S. F0R80DE 




7. ORKS 








9. THE STAUNTON LICK 




|lO. TBI nmoH ^ 



All content © GMR 2009 unless specifically stated. 



The open-source musicplayer, customised for GMR. 
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B Sourcecode Highlights 

radio/views. py 



# Change the address from localhost for production 

# Previous line unnessisary as of revision 14ish 

from dj ango . template import Context, RequestContext 
loader 

from django.http import HttpResponse 

from dj ango . contrib . auth . decorators import 

login_re quired 
from dj ango . contrib . auth import logout 
from dj ango . short cut s import render_to_response 
from django import http 

from gamemasterradio . radio . models import Track, 
GenreForm 

import operator 



@login_re quired 
def index ( request ) : 

def errorHandle ( error ) : 
form = RadioFormO 

return render_to_response ( 'radio ' 

' error ' 
'form' 



{ 

error 
form , 



}) 

if request . method == 'POST': # If the form has been 
submitted . . . 

form = GenreForm ( request . POST ) # A form bound to 

the POST data 
if f orm . is_valid () : # All validation rules pass 
speed = request . POST [' speed ' ] 
combat = request . POST [' combat ' ] 
suspense = request . POST [' suspense ' ] 
positive = request . POST [' positive ' ] 
return http . HttpResponseRedirect ( '/radio/listen/ 
' + speed + '-' + combat + '-' + suspense + ' 
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-' + positive) # Redirect after POST 

31 else : 

32 form = GenreFormQ # An unbound form 

33 

34 t = loader . get_template (' radio/ selectGenre . html ' 

) 

35 c = RequestContext ( request , { 

36 ' form ' : form , 

37 }) 

38 return render_to_response ( " radio/selectGenre . 

html", c) 

39 
40 

41 def logout_view (request ) : 

42 logout ( request ) 

43 return http . HttpRe spons eRedir e ct ( ' / ' ) 

44 

45 @login_re quired 

46 def listen (request , genre = False): 

47 

48 

49 #if (gSpeed) and (gCombat) and (gSuspense) and ( 

gPositive ) : 

50 #user has selected genre 

51 gSpeed = genre . split ("-") [0] 

52 request . session [' gSpeed ' ] = gSpeed 
53 

54 gCombat = genre . split ("-") [1] 

55 request . session [' gCombat ' ] = gCombat 

56 

57 gSuspense = genre . split ("-" ) [2] 

58 request . session [' gSuspense ' ] = gSuspense 

59 

60 gPositive = genre . spl it ( " - " ) [3] 

61 request . session [' gPositive ' ] = gPositive 

62 

63 genreName = gSpeed + "-" + gCombat + "-" + gSuspense 
+ "-" + gPositive 

64 
65 
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request . session [' genre ' ] = genre 
t = loader . get .template (' radio / 1 i st en . html ' ) 
c = RequestContext ( request , { 
' genreName ' : genre , 

}) 

return render _t o.response (" radio / 1 ist en . html " , c) 

@login_re quired 

def playlist (request ) : 

genreDict = O 
track_list_sorted = [] 

genre = request . session [' genre ' ] 
track_list = Track . obj ects . all () 

gSpeed = genre . split ("-") [0] 
gCombat = genre . split ("-") [1] 
gSuspense = genre . split ("-") [2] 
gPositive = genre . split ("-") [3] 



#Add all tracks to a dictionary with the track as 

the key, deviation as value 
for track in track_list : 

genreDict [track] = track . getDeviation (gSpeed , 
gCombat , gSuspense ,gPositive) 

#sort the dictionary by value, convert to a list of 
tuples 

genreList = sorted (genreDict . items () , key=operator . 
itemgetter (1) ) 

#discard the deviation values to get back to a track 
list 

for item in genreList : 

track_list_sorted . append (item [0] ) 

t = loader . get_template (' radio/playlist . xml ' ) 
c = Context ({ 
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101 ' track_list ' : track_list_sorted , 

102 ' genre ' : genre 

103 }) 

104 return HttpResponse (t . render (c) , mimetype^ 

application/xml ' ) 

105 

106 def crossdomain (request ) : 

107 t = loader . get _t emplate (' radio / crossdomain . xml ' ) 

108 c = Context ({ 

109 }) 

110 return HttpResponse (t . render (c) , mimetype^ 

application/xml ' ) 

111 

112 from gamemasterradio . radio . models import Feedback 

113 @login_required 

114 def contact ( request ) : 

115 if request . method == 'POST': # If the form has been 

submitted . . . 

116 #form = ContactForm ( request . POST) # A form bound 

to the POST data 

117 

118 if True: #f orm . is_valid () : # All validation 

rules pass 

119 
120 

121 #Create a new feedback item with data 

122 newFeedback = Feedback () 

123 newFeedback . user = request, user 

124 newFeedback . url = request . POST [ ' url ' ] 

125 newFeedback . sub j ect = request . POST [' sub j ect ' 

] 

126 newFeedback . description = reque st . POST [ ' 

description ' ] 

127 newFeedback . save ( ) 

128 

129 #Validaton passed 

130 html = "PASS" 

131 return HttpResponse (html ) 

132 

133 else: 
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#Validaton failed 

html = "FAIL" 

return HttpResponse (html ) 

else : 

#This is an AJAX view, it should always be sent 
POST data 

return http . HttpResponseRedirect ( ' / ' ) #bounce 
that sucker back home 

@login_re quired 
def nudge ( request ) : 

if request . method == 'POST': # If the form has been 
submitted . . . 

if True: #f orm . is_valid () : # All validation 
rules pass 



#grab vars from request 
trackID = request . POST [ ' id ' ] 
genreVar = request . POST [' genreVar ' ] 
up = request . POST [' up ' ] 

#Tweak current track 

track = Track . obj ects . get ( id__exact =trackID ) 
# <- TODO ID goes here ! 

returnGenreValue = "FAIL" #T0D0 : we should 
replace this with a check to see if the 
variable is initialised before the return 
# TODO I bet there's a better way of doing 

this . . . 
if genreVar == "gSpeed": 
if up == " True " : 

if track . gSpeed < 9: 

track . gSpeed = track . gSpeed + 1 
returnGenreValue = track. gSpeed 
elif track . gSpeed > 0: 

track . gSpeed = track . gSpeed - 1 
returnGenreValue = track. gSpeed 
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elif genreVar == "gCombat": 
if up == " True " : 

if track . gCombat < 9: 

track . gCombat = track . gCombat + 
1 

returnGenreValue = track . gCombat 
elif track . gCombat > 0: 

track . gCombat = track . gCombat - 1 
returnGenreValue = track . gCombat 

elif genreVar == "gSuspense": 
if up == " True " : 

if track . gSuspense < 9: 

track . gSuspense = track. 

gSuspense + 1 
returnGenreValue = track . 
gSuspense 
elif track . gSuspense > 0: 

track . gSuspense = track . gSuspense - 
1 

returnGenreValue = track . gSuspense 

elif genreVar == "gPositive": 
if up == " True " : 

if track . gPositive < 9: 

track . gPositive = track. 

gPositive + 1 
returnGenreValue = track . 
gPositive 
elif track . gPositive > 0: 

track . gPo s it ive = track . gPositive - 
1 

returnGenreValue = track . gPositive 

else : # bad data , bounce those suckers 

return HttpResponse (returnGenreValue) 

#Validaton passed 
track . save ( ) 
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return HttpResponse (returnGenreValue) 

else : 

#Validaton failed 

return HttpResponse (returnGenreValue) 

else : 

#This is an AJAX view, it should always be sent 
POST data 

return http . HttpResponseRedirect ( ' / ' ) #bounce 
that sucker back home 

@login_re quired 

def track ( request , trackID ) : 

try : 

track = Track . obj ects . get ( id=trackID ) 

#T0D0 : There's a lot of ifs here, there's 

probably a more elegant solution 
if track . gSpeed == 0: 

speedlsMin = True 
else : 

speedlsMin = False 

if track . gSpeed == 9: 

speedlsMax = True 
else : 

speedlsMax = False 

if track . gCombat == 0: 
combatlsMin = True 
else : 

combatlsMin = False 

if track . gCombat == 9: 
combatlsMax = True 
else : 

combatlsMax = False 
if track . gSuspense == 0: 
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suspense I sMin = True 
else : 

suspense I sMin = False 

if track . gSuspense == 9: 
suspense I sMax = True 
else : 

suspense I sMax = False 

if track . gPositive == 0: 
positivelsMin = True 
else : 

positivelsMin = False 

if track . gPositive == 9: 
positivelsMax = True 
else : 

positivelsMax = False 



except : 

return http . HttpResponseNotFound (' Track not 
found ! ' ) 
c = RequestContext (request , { 
'track' : track , 
'speedlsMin' : speedlsMin , 



' speedl sMax ' : 
' combatlsMin ' 
' combatlsMax ' 
' suspenselsMin 
' suspenselsMax 
' positivelsMin 
' positivelsMax 



speedlsMax , 
combatlsMin , 
combatlsMax , 

suspenselsMin , 
suspenselsMax , 
positivelsMin , 
po s it i ve I sMax 



}) 

return render _t o.response (" radio / track . html " , c) 
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radio/models. py 



from django.db import models 
from django import forms 

from dj ango . contrib . auth . models import User 

class Track (models . Model ) : 

name = models . CharField (max_length=200) 
artist = models . CharField (max_length=200) 
url = models . CharField (max_length=200) 
art = models . CharField (max_length=200) 
#Genre params 

gSpeed = models . IntegerField () 
gCombat = models . IntegerField () 
gSuspense = models . IntegerField () 
gPositive = models . IntegerField () 

def __unicode__ ( self ) : 
return self .name 

def getGenre ( self ) : 

return str ( self . gSpeed) + str ( self . gCombat ) + 
str ( self . gSuspense ) + str ( self . gPo s it ive ) 

def ensurePos it ive ( self , val ) : 
if val < 0: 

return val * -1 
else : 

return val 

def getDeviation(self , Speed , Combat , Suspense , Positive 
) : 

deviationSpeed = int(Speed) - self . gSpeed 
deviationCombat = int (Combat) - self . gCombat 
deviationSuspense = int ( Suspense ) - self. 
gSuspense 

deviationPositive = int ( Pos it ive ) - self. 
gPositive 

deviation = self . ensurePos it ive ( devi at ionSpeed ) 
+ self . ensurePositive (deviationCombat ) + self 
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. ensur ePo s it i ve ( devi at ionSuspense ) + self. 
ensurePositive(deviationPositive) 

return deviation 

class Feedback (models . Model ) : 

user = models . ForeignKey (User ) 
url = models . CharField (max_length=100) 
subject = models . CharField (max_length=20) 
description = models . TextField ( ) 

def __unicode__ ( self ) : 
return self .subject 

class GenreForm ( f orms . Form ) : 

speed = forms . CharField (max_length=l) 
combat = f orms . CharField (max_length=l ) 
suspense = forms . CharField (max_length=l) 
positive = forms . CharField (max_length=l) 

# demo data 

#class Choice (models . Model ) : 

# poll = models . ForeignKey (Poll ) 

# choice = models . CharField (max_length=200) 

# votes = models . IntegerField () 

#class Poll (models . Model ) : 

# question = models . CharField (max_length=200) 

# pub_date = models . DateTimeField (' date published') 
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